home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / cnflst12.zip / CONFLIST.TXT < prev   
Text File  |  1992-05-07  |  9KB  |  217 lines
  1. --------------------------------------------------------------------------------
  2. CONFLIST v1.2 - PCBoard Conference list processor                 May 92 Release
  3. --------------------------------------------------------------------------------
  4.  
  5. (c)1991,92 Key Research and Development.
  6. Written by Chris Lautenbach
  7.  
  8. NEW IN THIS VERSION
  9. ~~~~~~~~~~~~~~~~~~~
  10. A couple of little bugs have been fixed with color processing, and one where
  11. an odd number of conferences would end up having itself truncated to an even
  12. number.
  13.  
  14. In addition, a new specification type has been added; SINGLE.  This is for
  15. when you have one conference that needs to be different from the rest.
  16. Some people tried using RANGE for this, but specifying RANGE 60-60 for
  17. example, would cause CONFLIST to produce some pretty strange results.
  18.  
  19. So to avoid any problems, I've added this new type.
  20.  
  21. Also, the following switches have been added:
  22.  
  23. /?  -  shows help on available switches
  24. /n  -  negates adding of PCB @X codes.  Leaves output file pure ASCII.
  25. /v  -  verbose.  Gives all sorts of internal info, to help you find out
  26.        what's wrong with your config file if something odd is happening.
  27.  
  28. The next version will support a couple of new styles, including multi-page,
  29. color-coded, four-column color-coded, and multi-page four-column color-coded.
  30.  
  31. INTRODUCTION
  32. ~~~~~~~~~~~~
  33. I wrote this utility, because on my BBS, we were constantly adding new nets,
  34. new local conferences, changing conference names, etc etc.  I didn't want to
  35. have to waste time in an ANSI editor all the time making new menus.  I
  36. decided to sit down and write this program.
  37.  
  38. The program, in a nutshell, reads your CNAMES file, and produces a file 
  39. called CNFN.
  40.  
  41. CONFIGURING CONFLIST
  42. ~~~~~~~~~~~~~~~~~~~~
  43. Your config file (CONFLIST.CFG) should look something like this:
  44.  
  45. --------------------------------------------------------------------------------
  46. bordercolor =@X1F
  47. numcolor    =@X1E
  48. netcolor    =@X13
  49. namecolor   =@X1B
  50. undefined   =<blank>
  51. N-,front    =(NANet)
  52. S-,front    =(ShadowNET)
  53. -DV,inside  =(DevNet)
  54. 1-20,range  =(Local)
  55. 41,single   =Private!
  56. --------------------------------------------------------------------------------
  57.  
  58. The first five lines are static - meaning you should leave them there, in the
  59. order they are in.  The fields are as follows:
  60.  
  61. Bordercolor  - the color for the border of the conference menu.
  62. Numcolor     - the color for the conference numbers on the menu.
  63. Netcolor     - the color for the 'net' that the conference belongs to.
  64. Namecolor    - the color for the conference name itself.
  65.  
  66. Undefined    - this is the text that will be put beside conferences that
  67.                have no definition below.  (ie.  Local conferences) If you
  68.                want this to be blank, merely put "<blank>" in that field.
  69.  
  70. NOTE: The colors come predefined, as close to what PCB menus,etc would
  71.       normally look like.  Feel free to change them, just refer to the
  72.       PCBoard manual for actual @X?? color codes.  Theoretically, you
  73.       should be able to put ANSI codes in here instead of the PCB codes,
  74.       but I've never tried it.  If you do - let me know if it works.
  75.  
  76. DEFINING CONFERENCES
  77. ~~~~~~~~~~~~~~~~~~~~
  78. On our BBS, we've set up all the netmailed conferences, so that they are
  79. either suffixed or prefixed by a distinctive network 'id' so-to-speak.  For
  80. example; the NANet administration conference would be "N-NETADMIN", and 
  81. sysops would be "N-SYSOPS" and so-on and so-forth.  This is what the first
  82. method of indexing conferences is for:
  83.  
  84. N-,front=(NANet)
  85. ^   ^      ^
  86. |   |      |
  87. |   |      +------ This specifies the name of the network, how you'd like it
  88. |   |              to appear in your CNFN file beside the conference name.
  89. |   |
  90. |   +------------- This tells CONFLIST, to look for the conference identifier
  91. |                  at the beginning of the conference name.  The other method
  92. |                  similar to this one is, "inside", which will look for the
  93. |                  identifier ANYWHERE in the conference name.  (This can 
  94. |                  cause problems if your naming conventions are too simply
  95. |                  chosen.)
  96. |
  97. +----------------- And this - is the conference identifer.  Therefore, this
  98.                    whole line - would trap any conferences, that BEGIN with
  99.                    "N-"
  100.  
  101. The second:
  102.  
  103. -DV,inside  =(DevNet)
  104. ^   ^         ^
  105. |   |         |
  106. |   |         +--- Again, the name of the network.
  107. |   |
  108. |   |
  109. |   +------------- This tells CONFLIST that the conference identifier could
  110. |                  could be located anywhere within the string. (ie. BA-DV,
  111. |                  -DVBAD, L-DV-RT)
  112. |
  113. +----------------- See above.
  114.  
  115. The third:
  116.  
  117. 0-20,range=(Local)
  118.  ^     ^     ^
  119.  |     |     |
  120.  |     |     +---- Again, the name of the network.
  121.  |     |
  122.  |     +---------- This tells CONFLIST to to include all conferences within
  123.  |                 a specified range under this network name.
  124.  |
  125.  +---------------- This is the range of conferences to include.  Just make                                      
  126.                    sure there are no spaces in here.
  127.  
  128. And the final and newest:
  129.  
  130. 5,single    =(DevNet)
  131. ^   ^         ^
  132. |   |         |
  133. |   |         +--- Again, the name of the network.
  134. |   |
  135. |   |
  136. |   +------------- CONFLIST will only give this identifier to ONE conference,
  137. |                  and that's the one specified in the number at the beginning
  138. |                  of this statement.
  139. |
  140. +----------------- The number of the conference this identifier belongs to.
  141.  
  142. THE WRAP-UP
  143. ~~~~~~~~~~~
  144. CONFLIST is small and fast.  It's well under 20k in size, and on my 386-25,
  145. does over 200 conferences per second in non-verbose mode.  There is no limit
  146. to the maximum number of conferences, and a limit of 500 defined networks.
  147.  
  148. The only important thing to know, is that CONFLIST.EXE, CONFLIST.CFG and your
  149. CNAMES file must all be in the same directory.
  150.  
  151. In addition, I have only tested CONFLIST with PCBoard v14.5a/E3.  I doubt it
  152. makes any difference what /XX version you're running, but I wouldn't try it
  153. with anything less than PCB v14.5.
  154.  
  155. If you find this program useful, registration is only $15US.  Registration
  156. entitles you to download the registered version of CONFLIST, which allows you
  157. to specify the path of your CNAMES file, and the output path/filename for your
  158. CNFN file, and free upgrades forever.
  159.  
  160. Please, cheques and money orders only, do not send cash.  Mail registrations
  161. to:
  162.  
  163.                      Key Research and Development
  164.                           17 Annapearl Crt,
  165.                          Willowdale, Ontario
  166.                            M2N 4H6 CANADA
  167.  
  168. Make cheques payable to "Key Research and Development".
  169.  
  170. Also, call our support BBS:
  171.  
  172.        Toronto Twilight Communications
  173.  
  174.        (416) 733-9012
  175.  
  176.        5 nodes, 3.2gb online, two HST's, one Dual v.32bis!
  177.        Online role-playing games, RoseMail, Qmail, many online games!
  178.        NANet, ShadowNet, DevNet, EchoNet, BahNet, City2City mail networks
  179.        online, more coming soon.
  180.  
  181. --------------------------------------------------------------------------------
  182. Other fantastic Key Research and Development products           8-)
  183. --------------------------------------------------------------------------------
  184.  
  185.   GENius v1.5 - Complete personal communications system.  Includes;
  186.                 internal X/Y/Zmodem, full color EMS/XMS/RAM/DISK backscroll,
  187.                 up to 65,000 lines, full-featured script language, amazing
  188.                 macro capabilities and much much more!  You have to see it
  189.                 to believe it!
  190.  
  191.   PCMail Elite v1.0 - A great little .QWK mail reader, from the people
  192.                       who brought you GEnius.  Features are too many 
  193.                       to list.  Beats all the others by far.
  194.  
  195.   MiniDOS v1.2 - A fantastic miniature DOS shell.  Refers to files by
  196.                  numbers, not names.  This shortens most commands to
  197.                  a single letter, plus the number of the file to apply
  198.                  it to.  Standard DOS syntax is greatly relaxed as well,
  199.                  permitting use of / instead of \ in most cases.  File
  200.                  tagging (batch deletion/copying/etc) fully supported,
  201.                  internal support for shareware editors, list programs,
  202.                  and archivers.  Uses only 12k of RAM when running your
  203.                  applications.
  204.  
  205.   TexTils v1.0 - Text file manipulation utilites, remove lines from
  206.                  files, save them to other files.  Change all the
  207.                  occurances of one string in one or many files. Fully
  208.                  command-line driven.  Easy to use.  Comes with
  209.                  Turbo Pascal v6.0 source code.
  210.  
  211.   -------------------------------------------------------------------
  212.   GEnius is a trademark of Key Research and Development.
  213.   PC Mail Elite is a trademark of Key Research and Development.
  214.   ITCS is a trademark of Key Research and Development.
  215.   PCBoard is a trademark of Clark Development Corporation
  216.   -------------------------------------------------------------------
  217.